home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / wiz24a.zip / WIZ.DOC < prev    next >
Text File  |  1991-12-06  |  28KB  |  774 lines
  1.  
  2.                 WIZ version 2.4
  3.                by Ray Van Tassle
  4.                1020 Fox Run Lane
  5.              Algonquin, Ill, 60102
  6.                 (708)-658-4941
  7.                November 15, 1991
  8.  
  9.     WIZ program and manual copyright(c) 1990-1991 by Ray Van Tassle.
  10.  
  11.     Abstract:
  12.     WIZ is a lightning-fast file finder. It will find file(s)
  13.     based on full wildcard specifications (more powerful than
  14.     standard DOS wildcard), and can also filter by file size
  15.     and date.  It can:
  16.        * select only executable files (EXE, COM, BAT).
  17.        * select only archive files (ZIP, ARC, etc.)
  18.        * switch you to the disk\directory of a file that it found.
  19.        * execute a DOS command for each file it finds.
  20.        * look inside archives (ZIP, LZH, & ARJ)
  21.        * recursively look inside archives!
  22.        * Correct handling of the special files/directories created and
  23.          maintained by STACKER, Norton FILESAVE, and PCTOOLS DATA Sentry.
  24.  
  25.     It will look on multiple disk drives for all matching
  26.     filenames.  You can pre-specify several default lists of
  27.     disk drives for it to search.
  28.  
  29.  
  30.     WIZ program and manual copyright(c) 1990-1991 by Ray Van Tassle.
  31.  
  32.     WIZ is shareware, NOT freeware!!!
  33.  
  34.     You are granted a limited 21 day evaluation license. At the end
  35.     of that period, you should either delete it and stop using it,
  36.     or send in the registration fee of $15.
  37.  
  38.  
  39.  
  40.     MANUAL
  41.     ------
  42.     I was tempted to call this program YAFF (yet another file
  43.     finder), but I settled on WIZ.  This is a funny acronym for
  44.     "where is". But it's also short for WIZARD, because it's so
  45.     fast it seems like magic, and it's filename matching is so
  46.     powerful.
  47.  
  48.     It looks on one or more disks for all filenames (including
  49.     directories) that match the specified filename. By default, it
  50.     starts on drive C, and goes up until it runs out of disks.
  51.  
  52.     It has been tested, and works, with DOS 3.x, including Zenith
  53.     DOS 3.30, DOS 3.31, DOS 4.01, DOS 5.0, and On-Track
  54.     partitioning software.  DOS 3.31, 4.01, and 5.0 have large
  55.     (greater than 32MB) partitions with more than 65,536 sectors.
  56.     Zenith DOS 3.30 and On-Track have large partitions by virtue of
  57.     using large sectors (1024, 2048, or 4096 bytes, rather than
  58.     512 bytes).
  59.  
  60.     WIZ normally prints out, for each matching file, the filename,
  61.     date, time, size, and path.  The files are NOT ordered or
  62.     sorted.  All "special" files (hidden, system) are
  63.     flagged with a left-pointing triangle after the filename.
  64.     Optionally, it will list the files in normal fully-pathed form
  65.     (e.g., C:\UTIL\PGMS\ABC.BAT), suitable for processing by a
  66.     program which expects normal filenames.  When the found file
  67.     is inside an archive (-l flag), it will be listed in a form
  68.     suitable for the archiver (e.g.,
  69.     "C:\UTIL\PGMS\FOO.ZIP FILE.EXE")
  70.  
  71.     I deemed that most of the time, people (including me) want it
  72.     to be FAST, rather than in some particular order.
  73.     As WIZ reads the disk, it tries to optimize the head
  74.     motion, so directories are not processed in order of path, but
  75.     in the order that WIZ thinks will be quickest.  However, it will
  76.     generally look at the files in a directory before it looks at
  77.     the sub-directories.  However (especially if you have
  78.     directories with lots of files and sub-directories), it may
  79.     show some files in a directory, then show sub-directories, then
  80.     show more files in the directory.
  81.  
  82.     WIZ will ignore STACKER (tm) container files in the count of
  83.     files & MB's scanned.  STACKER is a disk expander utility
  84.     that keeps a compressed pseudo-disk in a container file.
  85.     This file has attributes of RHS, and is named "STACVOL.???".
  86.     
  87.     Likewise, WIZ will ignore the special hidden directories where
  88.     Norton's "FILESAVE" and PCTOOLS "DATAMON/SENTRY" move files that
  89.     have been deleted.  These tools & their directories are a super
  90.     undelete, and they are reported by DOS to have been deleted, but
  91.     the respective utilities really just have them tucked away in a
  92.     hidden place.  So WIZ treats these files as not being there, too.
  93.     
  94.  
  95.  
  96.     PERFORMANCE & Comparison with other file-find programs
  97.     ------------------------------------------------------
  98.     Some tests, run on a 10MHZ AT, searching for a non-existent
  99.     file on a large disk partitioned into drives C thru K,
  100.     8002 total files, 184MB in files, in 436 directories.
  101.  
  102.     Search        WIZ         WHEREIS        Norton FF
  103.     string        V2.3        V4.0        V4.5
  104.     --------       ----------      -----------     ------------
  105.     zzz.zzz        0:13        1:32        1:42
  106.     *.zzz        0:15        2:00 (*)        1:51
  107.     *.*zz        0:17        2:00        can't
  108.     *.zz*        0:15        2:01        1:51
  109.  
  110.                 (*) file_specifier was `*.* "?.zzz" '
  111.  
  112.     Looking inside archives (ZIP & LZH):
  113.                      WIZ        SST 5.2a
  114.                     -------            --------
  115.     24 archives, ?? files         0:13         0:18
  116.     418 archives. 4700 files     3:02         4:02
  117.  
  118.  
  119.     (Note: SST v5.2 is the new name for WHEREIS v5.2)
  120.  
  121.     WHEREIS V4.0 (and some others) can look within more types
  122.     of ARC, ZIP, etc. files than WIZ handles.  But WIZ is
  123.     much faster than any other file-finder (including Norton's),
  124.     and it's wildcard ability is much more powerful than most,
  125.     and easier to use than most others that are equally powerful.
  126.  
  127.     WIZ is also much smaller than these other programs.
  128.     Norton FF v4.5 is 9K,  WHEREIS v4.0 is 22K,  WIZv2.0 is 10K
  129.     SSTv5.2a is 44K.
  130.  
  131.  
  132.     ERRORLEVEL exit codes
  133.     ---------------------
  134.     0 = Normal exit.
  135.     1 = Normal exit. -g changes disk/path
  136.     2 = Bad command line.
  137.     255 = Internal error.
  138.  
  139.  
  140.     Error Messages
  141.     --------------
  142.         "Can't tell if FAT-12 or FAT-16. Assuming FAT-16!"
  143.         Just what it says.  I've only seen this on networked
  144.         disk drives.  If you know how to RELIABLY tell what
  145.         type of FAT a disk has (other than going thru DOS),
  146.         please let me know.
  147.  
  148.     "malloc failed for FAT_buf!"
  149.         Can't allocate memory to read a FAT block.  Most
  150.         likely an internal error.
  151.  
  152.      "malloc failed for dir_sec_buf!"
  153.         Can't allocate memory to read in a directory sector.
  154.         Most likely an internal error.
  155.  
  156.     "Sorry, out of memory!!!"
  157.         You lose.
  158.  
  159.     "Can't open file:"
  160.         Failure to open an archive file.  Most likely a disk
  161.         error. Run CHKDSK.
  162.  
  163.     "Internal error in ZIP/LZH/ARJ file"
  164.         The data read from in archive file isn't as expected.
  165.         Most likely the archive has a new format, and WIZ
  166.         hasn't yet been updated.  'Course, the archive file
  167.         may be corrupted.
  168.  
  169.  
  170.     BUGS
  171.     ----
  172.     No known bugs.  However, WIZ mostly does not use DOS to
  173.     process a disk, so errors on my part, or a change in the disk
  174.     structure might break it.  The most major bug reported was on
  175.     huge disk partitions under MS-DOS 4.01.  This bug caused WIZ
  176.     to read a random block from the disk, and treat it as a
  177.     directory.  It made a valiant attempt to march down all the
  178.     phony sub-directories, and would actually run for quite a
  179.     while before printing one of the "malloc failure" messages.
  180.  
  181.     If you are having problems, try 1) use the "-v" switch, to
  182.     isolate the error to a specific disk,  2) use "-vv", to see
  183.     as it hits each sub-directory,  3) use "*.*" to see all the
  184.     files, and watch until it walks off the edge of the world.
  185.     Then call or write me.
  186.  
  187.  
  188.     Command Line format and Switches
  189.     --------------------------------
  190.  
  191.     WIZ [disks:]file_pattern [-sN] [-dN] [-p] [-gN] [-x] [-m]
  192.         [-a] [-v] [-l[b][l]]  [-cS] [-zN] [-?] [>output-file-name]
  193.  
  194.     As usual, the stuff inside the square brackets "[]" are
  195.     optional and may be present or omitted. You do NOT include
  196.     the brackets in your command line.
  197.     The various fields and options may appear in any order, in
  198.     either upper or lower case.
  199.     The switch character can be either "-" or "/".
  200.  
  201.     You can have more than one set of "[disk:]pattern", and it
  202.     does the correct thing. That is, it scans each set in turn.
  203.     So you can say: "WIZ c:pyro* cd:*.cfg *.ovr".
  204.  
  205.     Except for size (-s) and date (-d), the options may be run
  206.     together.
  207.     For example: "WIZ -g20xp"   is the same as  "WIZ -g20 -x -p".
  208.  
  209.  
  210.  
  211.     If you just invoke WIZ without any parameters, it gives you a
  212.     brief help line.  For more info, include '-?'.  For even more,
  213.     include '-??'.
  214.  
  215.     If you leave out a pattern, but do have switche(s), WIZ assumes
  216.     that you want a pattern of "*".
  217.  
  218.     Disk(s): & filename_pattern
  219.     ---------------------------
  220.     1) [disks:]pattern
  221.     2) pattern
  222.     3) :pattern
  223.  
  224.     With format 1, you specify the disk(s) you want it to look at,
  225.     followed by ":".  It will look at those drives, in the order
  226.     you listed them.  If you list the same one twice, it will look
  227.     at it twice.  You can specify a range of disks by using a
  228.     dash--"C-F" is the same as "CDEF".
  229.  
  230.     With format 2, it will look at all drives beginning with C. It
  231.     will stop when it hits a drive that it cannot read.
  232.  
  233.     With format 3, it will look at all drives beginning with A. It
  234.     will stop when it hits a drive that it cannot read, except A &
  235.     B.  If the floppy drive has a disk in, it will look at it,
  236.     otherwise it will ignore the floppy drive.
  237.  
  238.     If you have only one floppy drive, WIZ will check to see if DOS
  239.     last used it as A or B, and will skip the other drive letter
  240.     (B or A).
  241.  
  242.     You do not (and cannot) specify path or directory names,
  243.     because WIZ searches an entire disk.
  244.  
  245.  
  246.     Processing Disk(s) and Environment Variable
  247.     -------------------------------------------
  248.     You can over-ride the disks that WIZ looks at, and their
  249.     order, by making an environment variable "WIZ".  Do:
  250.     "SET WIZ=floppy-disk-list:hard-disk-list". Example:
  251.     "SET WIZ=AB:C-M".  What actually happens is that WIZ will
  252.     try to read all the disks to the left of the colon, then all
  253.     those to the right of the colon.  Those on the left are
  254.     deemed to be floppies, and it will keep going if it can't
  255.     read one.  Those on the right are deemed to be hard drives,
  256.     and it will quit on the first one that it can't read.
  257.  
  258.     If you specify disks on the command line, it will try to read
  259.     them all, even if it can't read one.
  260.  
  261.     The list may be discontiguous, (e.g., "C-FL-M").  This is
  262.     mostly useful if you are on a network, which tends to make
  263.     the networked disks at the higher letters, and leaves a hole
  264.     before them.
  265.  
  266.  
  267.     Pre-defined Drive Sets
  268.     ----------------------
  269.     You can actually have several pre-defined sets of disks to
  270.     search. If the disk-specifier on the command line is a single
  271.     digit (0-9), it will look for that specifier in the WIZ
  272.     variable.  For example, you might say:
  273.         "SET WIZ=AB:C-F  1=CDEF 2=AB:  3=C-Z 4=C-Z:"
  274.  
  275.     As above, those to the left of the colon are deemed floppies,
  276.     and WIZ will keep going if it can't read one; those to the
  277.     right are hard drives, and WIZ will quit if it can't read one.
  278.     However, if there isn't a colon, then they are ALL deemed to
  279.     be hard drives.
  280.  
  281.     The command "WIZ z.z", will look on ABCDEF.
  282.     The command "WIZ 1:z.z", will look on CDEF.
  283.     The command "WIZ 2:z.z", will look on AB.
  284.     The command "WIZ 3:z.z", will look on all drives C-Z (and
  285.         will quit at the first on that it can't read).
  286.     The command "WIZ 4:z.z", will look on all drives C-Z (and it
  287.         will attempt to read each and every one of them).
  288.     The command "WIZ 9:z.z", will give an error message.
  289.  
  290.  
  291.  
  292.  
  293.  
  294.     PATTERN:
  295.     --------
  296.     I call it "pattern" rather than "filename", because WIZ
  297.     does a full pattern-match against the actual filenames it
  298.     reads from the disk.  The pattern has three special characters
  299.     (called meta-characters), plus all the other characters
  300.     possible in a filename.
  301.  
  302.     1)  "*" (star)
  303.     2)  "?" (question mark)
  304.     3)  "." (dot),
  305.  
  306.     1) "*"    This is the "rubber" wildcard meta-character.  The
  307.         star will match as many characters as possible, from
  308.         none to the entire filename.  It is "rubber", because
  309.         it will shrink & stretch to match as many characters
  310.         as required.
  311.  
  312.     2) "?"    This is the "single" wildcard meta-character.  It will
  313.         match exactly ONE character in the filename.
  314.  
  315.     3) "."  This is the "separator" meta-character (it is NOT a
  316.         wildcard character).
  317.         If you specify a dot in the pattern, the disk filename
  318.         (and the pattern) is treated as having two parts,
  319.         one before the dot, and one after the dot.
  320.         Each part undergoes it's own pattern matching.
  321.  
  322.     If you don't have any meta-characters in the filename pattern,
  323.     WIZ appends a "*" on the end of what you specified.
  324.  
  325.     Proper pattern matching (like WIZ does) is almost a D.W.I.M.
  326.     (do what I mean) operation.  DOS's wildcards are so primitive
  327.     that it is professionally embarrassing.  Not only that, but the
  328.     pattern-matching subroutine in WIZ is only a couple of dozen
  329.     lines of code.  And it's surprisingly fast.
  330.  
  331.     To give some examples:
  332.     *A*     means:
  333.         any file which has an A anywhere in it, on either side
  334.         of the dot.
  335.  
  336.     Z*    Any file that starts with a Z
  337.         (ZZBC.BAT    Z.Z)
  338.  
  339.     ?.    Any filename that has exactly one character in it, and
  340.         has no extent.  (A.   B.   but not    AB.   or A.BAT)
  341.  
  342.     ?*      Any filename that isn't totally blank.
  343.  
  344.     A*T    any file that starts with A and ends with T in the
  345.         extent. (ABCDE.BAT     A.T    AB.ERT but not ABCERT.)
  346.  
  347.     A*T.    any file that starts with A and ends with T, and
  348.         has no extent. (ABCERT.      but not ABCERT.RST)
  349.  
  350.     A*T.*    any file that starts with A and ends with T, whether or
  351.         not it has an extent.
  352.         (ABCERT.    ABCERT.RST    ABCDET.COM)
  353.  
  354.     A*B*Z.* any file that starts with A then somewhere to the right
  355.         has a B, then ends with Z, and has any extent.
  356.         (ABZ.BAT    AMNOBPQRZ.   ABYXZ.COM)
  357.  
  358.     *.C    any file with an extent of C
  359.  
  360.     W*.C    any file that starts with W and has a C extent. (W.C
  361.         WIZ.C  WIZ14.C)
  362.  
  363.     W*4.C    any file that starts with W, ends with 4, and has an
  364.         extent of C.
  365.  
  366.     ???.C    any file that has exactly 3 characters in the name, and
  367.         an extent of C.
  368.  
  369.     Directories also participate in the filename matching.  A lot
  370.     of other whereis programs don't tell you about directory names
  371.     that match.  I find this annoying, because many times I can
  372.     remember the directory name (or at least part of it), but not
  373.     the file names.  This is especially true for things that I
  374.     have downloaded.  Since directories normally don't have an
  375.     extent (although they can), for matching purposes a directory
  376.     that does not have an extent is treated as if it has a blank
  377.     extent, so it has a dot.  But when it is printed out, this
  378.     implied dot isn't printed.
  379.  
  380.     POPDROP.  will match the directory name "POPDROP"
  381.           and the filename "POPDROP.", but not "POPDROP.COM"
  382.  
  383.     POPDROP.* will match all of the above
  384.  
  385.     POPDROP   will match all of the above, but also POPDROP2.COM
  386.           etc.
  387.  
  388.  
  389.  
  390.  
  391.     -s Size qualifier
  392.     -----------------
  393.     Files may be further filtered by their size. Either or both
  394.     minimum and maximum size may be specified. A file will match
  395.     only if it's size falls between the two limits, inclusive.
  396.     Note that a directory, while it is really a file, is not
  397.     considered to have a size, so directories will NEVER show up
  398.     if you give a size qualifier. This gives a way to never show
  399.     directories: just add "-s0".  All other files have a size
  400.     that is greater than or equal to zero.
  401.  
  402.     -s[low_limit][:hi_limit]
  403.  
  404.     -s100        Files that are 100 or more bytes large.
  405.  
  406.     -s:10000    Files that are 10000 or less bytes large.
  407.  
  408.     -s500:600    Files whose size is greater than or equal to
  409.             500 bytes, and less than or equal to 600 bytes.
  410.  
  411.     -s1000:1000    Files that are exactly 1000 bytes large.
  412.  
  413.  
  414.  
  415.     -d Date qualifier
  416.     -----------------
  417.     Files may also be filtered by date.  Either or both
  418.     lowest & highest date may be specified. A file will match
  419.     only if it's date falls between the two limits, inclusive.
  420.  
  421.     -d[low_date][:high_date]
  422.  
  423.     The format for date is MM/DD/YY or MM-DD-YY.  The year
  424.     can be given as either "91" or "1991".
  425.  
  426.     -d1/1/90    Files dated on or after Jan 1, 1990.
  427.  
  428.     -d:12-31-87    Files dated on or before Dec 31, 1987.
  429.  
  430.     -d1-1-90:12-31-1990  Files dated anytime in 1990.
  431.  
  432.     -d12/12/90:11/11/90  No files---it's impossible for a file to
  433.             be dated after Dec 12, 1990 and before
  434.             Nov 11, 1990 (inclusive)
  435.  
  436.  
  437.  
  438.     -p    List in canonical pathname format
  439.     ---------------------------------------
  440.     The matching files are listed in normal DOS format:
  441.         disk:\path\name.ext
  442.     If the "-l" flag ("look inside archives") is given,
  443.     the format is:
  444.         disk\path\archive-name.zip filename.ext
  445.  
  446.     Date, time, size are not given.  This type of list
  447.     is presumably going to be fed into a program as a
  448.     list of files, so directories will not be listed.
  449.  
  450.  
  451.  
  452.     -g     Go to directory
  453.     ----------------------
  454.     This will change your path to the disk & directory of the
  455.     Nth file in the list of files that matched.  If you omit
  456.     N (or N is zero), it will ask you at each match if that is
  457.     where you want to go.
  458.  
  459.     If that file is a directory, WIZ will set the path to that
  460.     directory.  On the other hand, if it is a file, WIZ will set
  461.     the path to be the directory that the file is in.
  462.  
  463.     Obviously, if N is larger than the number of files that match,
  464.     nothing will happen.
  465.  
  466.     -g5    Will change to the path of the 5th listed file.
  467.     -g1    Will change to the path of the first listed file.
  468.     -g    Will ask you at each matched file if it should change
  469.         to the path of the listed file.
  470.  
  471.  
  472.     -x    Executable files
  473.     ----------------------
  474.     This switch will set a pre-filter, and select only executable
  475.     files (.BAT, .COM, .EXE) that pass the other filters (size,
  476.     date, pattern).  For this to work properly, the pattern should
  477.     either not have a dot, or terminate with ".*" (because this is
  478.     just an additional filter, albeit one with three holes).
  479.  
  480.     I added this because a lot of times I find myself looking for
  481.     a handy but seldom-used program, and I can never remember if
  482.     it's a COM or an EXE file.  And if I put "*FOO*.*", WIZ lists
  483.     everything, including the directory, DOC, README, etc.
  484.  
  485.  
  486.     -m    More (pause)
  487.     ------------------
  488.     Act like "MORE"--pause and wait for a key to be hit after each
  489.     screenful of lines have been displayed.  It checks how many
  490.     lines are actually displayed on the screen (25, 28, 43, 50, etc.)
  491.  
  492.  
  493.     -a    Archive files
  494.     -------------------
  495.     This works just like "-x", except it's for archive files.
  496.     These are ZIP, ARC, LZH, ZOO, ARJ, PAK.
  497.  
  498.  
  499.     -v    Verbose
  500.     -------------
  501.     If you have this flag once, WIZ will print the disk name when
  502.     it starts as it starts on a disk.  If you have it twice
  503.     (-vv), it will also print the name of each directory as it
  504.     starts processing it.  This is mostly useful for trouble
  505.     shooting, or to see a progress indication.
  506.  
  507.  
  508.     -l    Look inside archives
  509.     --------------------------
  510.     This switch will make it look inside archives (ZIP, LZH, and
  511.     ARJ archives only), for a matching filespec.  Note that all
  512.     the filters apply to the file INSIDE the archive, and NOT to
  513.     the archive itself.  The disk list will, however, still
  514.     specify the disks to look at.
  515.  
  516.     Both PKZIP and ARJ come with information on the internal
  517.     format of their archive files, including the header.  Neither
  518.     LHARC nor LHA do, but it was pretty easy for me to figure
  519.     out.  I do ZIP's because that is currently the most common
  520.     type of archive.  LHA compresses smaller, but lacks a few
  521.     features, and is slower in compressing.  ARJ is the BEST.  It
  522.     packs 5% - 10% tighter than ZIP (but is slower in
  523.     compressing), and includes all the nice features of ZIP,
  524.     including encryption, comments, etc, and also can
  525.     automagically create a segmented archive, so you can put a
  526.     huge archive onto several floppy disks, without having to use
  527.     SLICE/SPLICE.  It also comes with a handy utility to convert
  528.     any other archive type to ARJ's.  I didn't do any other
  529.     archivers, because 1) I don't have information on the
  530.     internal format, 2) these three are the most common, and
  531.     best, and 3) I don't want WIZ to get any larger than
  532.     necessary.
  533.  
  534.     -ll    Look inside archives recursively
  535.     ---------------------------------------
  536.     This switch will tell WIZ that you want it to also look
  537.     inside archives that are themselves in an archive.  Naturally,
  538.     WIZ can only do this if the inside archive is "stored" (no
  539.     compression).  With ZIP (and LHA) this is no problem, as PKZIP
  540.     normally cannot and will not compress a ZIP file when you
  541.     include it in another ZIP file.  (Ditto for LHA).  However, ARJ
  542.     can (and WILL) compress a ZIP file as it adds it to an ARJ file!!
  543.     'Course, it's pretty kinky to recursively store ZIPs in an
  544.     ARJ.  You normally would not mix them this way.  To see how
  545.     this works, do "WIZ -ll call_wiz*.*".  This will show you the
  546.     various CALL_WIZ files that are in the WIZnn.ZIP, in
  547.     CALL_WIZ.ZIP.
  548.  
  549.     In the output, these show up with a "@" where you would
  550.     normally see "\", which indicates that it's "kind of like" a
  551.     path.  If this pseudo-pathname gets too long, a "+" is tacked
  552.     on at the end, instead of the actual filename; one for each
  553.     level that is being omitted.
  554.  
  555.     You can also use the "-c" switch, but the filename that
  556.     replaces the "*" in the command won't make any kind of sense
  557.     to DOS, ARJ, LHA ZIP, etc., because of the "@" characters.
  558.  
  559.     -b    Both
  560.     ------------
  561.     This switch is used with "-l" to look both at normal files,
  562.     and inside archives.
  563.  
  564.  
  565.     -zN    Pass back information to calling program
  566.     ------------------------------------------------
  567.     See "CALL_WIZ.DOC".
  568.  
  569.  
  570.     -c    Execute a command
  571.     -------------------------
  572.     This lets you execute a DOS command for each matching file.
  573.     The format is '-cCOMMAND' or '-c COMMAND'. However, if the
  574.     COMMAND has any special characters (space, |, <, >, etc.) you
  575.     must enclose it in quotes: '-c"COMMAND"'.
  576.  
  577.     Each occurance (if any) of the character "*" in the command is
  578.     replaced by the complete file-name (including disk and path).
  579.  
  580.     WIZ will spawn a new copy of the command-line shell
  581.     (COMMAND.COM, 4DOS, etc.), and pass it the built command. The
  582.     one exception is that the command "del*" or "del *" (to
  583.     delete the file) is handled internally by WIZ itself.  (Note
  584.     that you can use the form: '-cdel*', and you do not need a
  585.     space before the '*', nor do you need to enclose the command
  586.     in quotes.)  For this command, WIZ will prompt you to confirm
  587.     each file to be deleted.  (I did this because deleting files
  588.     is a handy thing to do, and it's quicker to do it inside of
  589.     WIZ than to spawn a shell to do it.  But I'm no fool!! You
  590.     have to confirm that you want delete, for each file.  No
  591.     way am I going to let it merrily delete every file on my
  592.     disk(s) just because I make one little mistake on the command
  593.     line!!)   If you prefer to have the shell handle the file
  594.     deletions, use "erase *" or "delete *".
  595.  
  596.     You can't do "-cdel*" along with "-l".  If you have given the
  597.     -l switch, the '*" is replaced with the complete filename of
  598.     the archive (.ZIP, .LZH, .ARJ), a space, and then the
  599.     filename.
  600.  
  601.     Examples:
  602.         -c"type *"    -- type each matching file
  603.         -c"more <*"    -- ditto, with a pause for each page
  604.         -c"copy * a:\"    -- copy each matching file to A:
  605.         -c"set"        -- display the environment at each
  606.                    matching file.
  607.         -c"pkunzip *"    -- extract matching files from a ZIP
  608.                    archive.
  609.  
  610.  
  611.  
  612.  
  613.  
  614.     Coming Attractions
  615.     ------------------
  616.     An interactive screen interface.
  617.     It will gather the file names instead of just printing them
  618.     out.  Then you will be able to sort by name, extent, disk,
  619.     date, size.  You'll also be able to tag files and delete, copy,
  620.     move them, and find duplicates.
  621.     Plus other things I think of, or get suggested.
  622.  
  623.     This is shareware, so I'm probably more interested and 
  624.     receptive in hearing comments and suggestions than a commercial 
  625.     software publisher would be.  Just send them in, or give me a 
  626.     call.  I can't promise to fix bugs, or add specific features, 
  627.     but I'll listen to everything.  Even if you're cheap and 
  628.     haven't registered.
  629.  
  630.     
  631.     BBS Support & New Versions
  632.     --------------------------
  633.     There is no "official" support BBS.  However, I frequent a couple
  634.     of local BBS's:
  635.         Chicken Coop (708)658-1545   RIMENET =>THECOOP
  636.         Emporium     (708)551-4275        
  637.         
  638.  
  639.     Update History
  640.     --------------
  641.  
  642.     1.6
  643.     Initial public release
  644.  
  645.     1.7
  646.     Bug fixes
  647.  
  648.     1.8
  649.     Changed "-g" operation. Quit as soon as we hit the correct
  650.     one.  Sound an alarm bell when we set disk/directory.
  651.  
  652.     1.81 (not released)
  653.     * Fix for huge disks. I tested with 100+ MB disk, but failed
  654.     to test with a nearly full disk. Result=BUG!! -- (overflow in
  655.     intermediate calculation, converting cluster to sector
  656.     number.)  Thanks, Eddie, for running DOS 4.01 with one huge
  657.     >32MB partition--which all the gurus recommend against!
  658.  
  659.     1.9
  660.     * Fixed bug in handling full root directory.
  661.     * Changes in walking the directory tree.  Made it
  662.       non-recursive; changed the way I collect pathname to print.
  663.     * Added -c switch.
  664.     * Fix bug in handling a sub-directory that is exactly and
  665.       evenly full, with no next cluster.
  666.  
  667.     1.91
  668.     * Slightly faster
  669.     * Added -a switch
  670.  
  671.     2.00
  672.     * Slightly smaller and faster.
  673.     * Creeping featurism!!
  674.     * Added -l switch, to look inside archives
  675.     * Decided that the ability to look inside achives should
  676.       signify a new major version, so it's now 2.0
  677.  
  678.     2.1
  679.     * Mod for stacker container files.
  680.     * Speeded up some filename checks (2 times in some cases)
  681.  
  682.     2.2
  683.     * Better disk-name processing.  Added WIZ environment
  684.       variable.
  685.     * Fixed bug introduced in 1.9 on pattern matching of
  686.       directory-names, with dot in pattern & no extent.
  687.     * Reset counts at the start of each path.
  688.  
  689.     2.3
  690.     * Fixed matching of directory names (a very subtle bug!!)
  691.     * Added -z flag (for other programs to call WIZ).
  692.     * Changed -g0 to query at each matching file.
  693.     * Changed date format. Included seconds in the time.
  694.     * Added checking for the "other" floppy disk, if there is only
  695.       one configured on the computer.
  696.  
  697.     2.4
  698.     * Changed order of size/date/time to be in the same as DIR.
  699.     * Removed seconds from the time.
  700.     * Added -b switch, to allow it to look at normal files, and
  701.       inside archives, on the same pass thru the disk(s).  This
  702.       was the single most requested modification.
  703.     * Added ability to recursively look in archives.
  704.     * If no pattern specified, but only switches, assume "*".
  705.     * Some more speed-up optimization; some minor bugs fixed,
  706.       including another one with HUGE disks.
  707.     * Added -m switch.
  708.     * Check for CTRL-BREAK flag (not CTRL-C!!), to bail out 
  709.       quickly.
  710.  
  711.     ********
  712.     Programming notes (if anyone is interested):
  713.  
  714.     The way I scan thru the disk, it pretty much sweeps thru
  715.     the disk from front to back, without (much) hopping back &
  716.     forth.  So it scans the 1st cluster of ALL the directories
  717.     and sub-directories on the disk, then makes a pass thru the
  718.     FAT (from start to end within the FAT), and so on.
  719.  
  720.     This optimization of head movement really helps to speed it
  721.     up, especially if you don't have a fast disk.  The
  722.     unfortunate side effect is that it looks at a directory one
  723.     chunk at a time, interspersed with chunks of other
  724.     directories.  But it sure is fast!!
  725.  
  726.  
  727.  
  728.                            --------------------------
  729.                              INVOICE / REGISTRATION
  730.                            --------------------------
  731.  
  732.  
  733.  
  734.           Sold to: ___________________________________________________
  735.  
  736.                    ___________________________________________________
  737.  
  738.                    ___________________________________________________
  739.  
  740.  
  741.              Date: ______________________________
  742.  
  743.  
  744.           ============================================================
  745.  
  746.  
  747.  
  748.  
  749.           _____ copies of WIZ version 2.4 at $15 each $____________
  750.  
  751.  
  752.                                 TOTAL ENCLOSED.......  $____________
  753.  
  754.       Where did you get your copy of WIZ?
  755.       Shareware distributor name:___________________
  756.       BBS name: ____________________
  757.       BBS phone #:  ____________________
  758.  
  759.  
  760.                       Send this invoice and your check to:
  761.  
  762.                 Ray Van Tassle
  763.                 1020 Fox Run Lane
  764.                 Algonquin, Il. 60102
  765.                 (708)-658-4941
  766.  
  767.  
  768.  
  769.  
  770.           =============================================================
  771.  
  772.           Thank you for your support ............... Ray Van Tassle
  773.  
  774.